_h_t_m_l__p_a_c_k_a_g_e is part of iiiinnnnssssiiiigggghhhhtttt____ddddeeeevvvv, the IIIInnnnSSSSiiiigggghhhhtttt DDDDeeeevvvveeeellllooooppppeeeerrrr BBBBooooooookkkk BBBBuuuuiiiillllddddiiiinnnngggg
TTTToooooooollllssss. It can be used to convert an InSight book (see _i_n_s_i_g_h_t(_1)) to
HTML.
_h_t_m_l__p_a_c_k_a_g_e is a wrapper which encapsulates two sub-programs: ddddttttllll2222hhhhttttmmmmllll
and sssspppplllliiiitttthhhhttttmmmmllll. These programs may be run individually if more control
over the output is required. Their command line usage statements are
included at the end of this document.
Additional customization can be done via the sssspppplllliiiitttthhhhttttmmmmllll configuration
file, sssspppplllliiiitttthhhhttttmmmmllll....ccccffffgggg. Examine the contents of that file for further
information.
The HTML files that are produced can be read through a web server or
viewed from the file system using any standard web browser (such as
_n_e_t_s_c_a_p_e(_1)).
By default, _h_t_m_l__p_a_c_k_a_g_e also creates a _t_a_r(_1) file containing the
newly-created HTML files (and images) for the purpose of easily moving
the files to alternate locations. This file will be created in the same
directory as specified by the oooouuuuttttppppuuuutttt____ddddiiiirrrreeeeccccttttoooorrrryyyy parameter (or the default
location).
OOOOPPPPTTTTIIIIOOOONNNNSSSS
Command line options are described below.
bbbbooooooookkkk____nnnnaaaammmmeeee
bbbbooooooookkkk____nnnnaaaammmmeeee is a required option which mmmmuuuusssstttt appear as the last option
on the command line. The bbbbooooooookkkk____nnnnaaaammmmeeee is the abbreviated short title
for the book. See _i_n_s_i_g_h_t(1) for more details on bookshelves.
-s The -s bbbbooooooookkkksssshhhheeeellllffff____ppppaaaatttthhhh option tells _h_t_m_l__p_a_c_k_a_g_e which specific
bookshelf the bbbbooooooookkkk____nnnnaaaammmmeeee is on. See _i_n_s_i_g_h_t(1) for more details on
bookshelves.
By default, _h_t_m_l__p_a_c_k_a_g_e looks in the current working directory for
the existence of a bbbbooooooookkkkssss////<<<<bbbbooooooookkkk____nnnnaaaammmmeeee>>>> directory, which should contain
the IIIInnnnSSSSiiiigggghhhhtttt book to convert. If not found, an error is reported.